Skip to content
Skills Library
Programming · Building & coding

bone

/bone

为项目搭建 agent 工作区骨架:入口契约、项目定义、状态、决策、任务卡、知识层、产出区共 11 个文件;并对已有工作区做 10 项可判定的体检。项目定义、目标、不做什么、第一个任务这些核心字段通过逐轮审问确定,不由模型生成;项目已有 README、代码、笔记或半成品骨架时,先采集证据再逐条确认,不清空重来。当用户要新建项目工作区、给现有仓库补 agent 上下文、提到「搭骨架」「工作空间」「AGENTS.md」「入口契约」「STATE.md」「任务卡」「上下文连续」,或抱怨「每次都要重新解释背景」「换个会话就忘了做到哪」「上下文断了接不上」时使用,即使用户没有明确说要搭骨架。不适用于:编写或修改单个 skill、整理笔记、已有工作区只想改某一个文件的内容。

Repository
bone-skill ↗
Licence
MIT
Last repository change
02.11.2026

Assessment and security

95/ 100Class: good
Format20 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
5
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 02.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

为项目搭建 agent 工作区骨架:入口契约、项目定义、状态、决策、任务卡、知识层、产出区共 11 个文件;并对已有工作区做 10 项可判定的体检。项目定义、目标、不做什么、第一个任务这些核心字段通过逐轮审问确定,不由模型生成;项目已有 README、代码、笔记或半成品骨架时,先采集证据再逐条确认,不清空重来。当用户要新建项目工作区、给现有仓库补 agent 上下文、提到「搭骨架」「工作空间」「AGENTS.md」「入口契约」「STATE.md」「任务卡」「上下文连续」,或抱怨「每次都要重新解释背景」「换个会话就忘了做到哪」「上下文断了接不上」时使用,即使用户没有明确说要搭骨架。不适用于:编写或修改单个 skill、整理笔记、已有工作区只想改某一个文件的内容。

Original author description

为项目搭建 agent 工作区骨架:入口契约、项目定义、状态、决策、任务卡、知识层、产出区共 11 个文件;并对已有工作区做 10 项可判定的体检。项目定义、目标、不做什么、第一个任务这些核心字段通过逐轮审问确定,不由模型生成;项目已有 README、代码、笔记或半成品骨架时,先采集证据再逐条确认,不清空重来。当用户要新建项目工作区、给现有仓库补 agent 上下文、提到「搭骨架」「工作空间」「AGENTS.md」「入口契约」「STATE.md」「任务卡」「上下文连续」,或抱怨「每次都要重新解释背景」「换个会话就忘了做到哪」「上下文断了接不上」时使用,即使用户没有明确说要搭骨架。不适用于:编写或修改单个 skill、整理笔记、已有工作区只想改某一个文件的内容。

How it works

  1. 它是什么
  2. 两条铁律
  3. 何时用 / 何时不用
  4. 生成什么
  5. 流程
  6. 规则表
  7. 失败分支
  8. 资源加载指引
  9. 反模式
  10. 自检
Original SKILL.md headings · 243 lines, 964 words
SKILL.md preview
---
name: bone
description: "为项目搭建 agent 工作区骨架:入口契约、项目定义、状态、决策、任务卡、知识层、产出区共 11 个文件;并对已有工作区做 10 项可判定的体检。项目定义、目标、不做什么、第一个任务这些核心字段通过逐轮审问确定,不由模型生成;项目已有 README、代码、笔记或半成品骨架时,先采集证据再逐条确认,不清空重来。当用户要新建项目工作区、给现有仓库补 agent 上下文、提到「搭骨架」「工作空间」「AGENTS.md」「入口契约」「STATE.md」「任务卡」「上下文连续」,或抱怨「每次都要重新解释背景」「换个会话就忘了做到哪」「上下文断了接不上」时使用,即使用户没有明确说要搭骨架。不适用于:编写或修改单个 skill、整理笔记、已有工作区只想改某一个文件的内容。"
---

# bone

## 它是什么

给一个项目生成「agent 的外部记忆」目录:让新会话不用问你就能接上活,让任务不靠对话里的临时约定来约束。

骨架解决的是一个具体问题:**上下文窗口会清零,文件不会。** 所以约束必须落在文件里,不能留在对话里。

## 两条铁律

**第一条:机器只复制结构,不生成判断。**

11 个文件的结构是确定的,复制就行。但那 6 个核心字段——项目做什么、怎么算成功、明确不做什么、第一个任务是什么——模型凭空写出来的一定不准,因为它没有依据,只能按常见情况推断。而 `PROJECT.md` 里的每一句都会被后续会话当成事实引用。

**第二条:有出处的叫提取,没出处的叫编造。**

项目已经有 README、代码、笔记时,核心字段可以从上下文里读——但只有**原文直述**(E1)才能直接写进去。从结构推测的(E2)只能当审问的推荐答案,等用户点头。找不到的(E3)照旧问。

这条是第一条的延伸,不是例外。把 E2 写进 `PROJECT.md`,等于换了个渠道编造。

## 何时用 / 何时不用

**用:**
- 新项目开工,还没有任何 agent 约定文件
- 已有仓库(有代码、有 README),但每开一个新会话都要重新交代背景
- 想把「任务卡」「收工回流」这套流程落到具体文件上
- 接手一个已有工作区,想知道它缺什么、哪里写废了

**不用:**
- 写或改单个 skill —— 那是 skill 编写流程,跟工作区骨架无关
- 整理笔记、归档文件 —— 没有「跨会话接手」的需求就不需要这套结构
- 已有工作区只想改某一个文件的一处内容 —— 直接改,不用走这套流程

## 生成什么

11 个文件,分成四层:

| 层 | 文件 | 作用 |
|---|---|---|
| 入口 | `AGENTS.md` | 读取顺序、文件地图、硬约束、收工定义 |
| 设定 | `PROJECT.md` `STATE.md` `DECISIONS.md` `PERSONA.md` | 项目是什么 / 做到哪 / 定了什么 / 人设偏移 |
| 知识 | `knowledge/GLOSSARY.md` `knowledge/CONVENTIONS.md` | 术语、命名、技术栈 |
| 流程 | `process/WORKFLOW.md` `process/TASK_TEMPLATE.md` `tasks/BACKLOG.md` `outputs/README.md` | 开工收工、任务卡、任务索引、产出区 |

为什么拆这么细:**寿命不同。** 项目定义几乎不变,状态每天变,决策只增不改。混成一个文件,频繁改的部分会稀释稳定的部分,半年后没人愿意读。

### 两档:完整 11 / 轻量 8

| 档 | 文件 | 用在 |
|---|---|---|
| `full` | 上面 11 个 | 要长期沉淀知识、需要人设偏移的项目 |
| `lite` | 去掉 `PERSONA.md`、`knowledge/GLOSSARY.md`、`knowledge/CONVENTIONS.md` | 单人小项目、生命周期短的实验、一次性脚本 |

轻量档砍人设和知识层,**保留两个 `process/` 文件**——`WORKFLOW` 和 `TASK_TEMPLATE` 是骨架能运转的最小集。砍掉它们,剩下的就只是几个说明书,约束会散进 `AGENTS.md` 被后续任务逐步改掉。

档位只影响生成哪些文件,以及 `AGENTS.md` 文件地图的长度(`init.py` 自动裁剪)。其他规则两档完全一致。

**本项目按单人自用设计。** 幂等防的是"我覆盖你的已有内容",不防"两个人同时写"。团队共享一个工作区时,并发写冲突没有处理——这是已知缺口,不是遗漏。

## 流程

### Phase 0 探测与采集(只读,不写盘)

不做探测直接生成,等于给所有项目套同一个壳。

```bash
ls -A <目标目录>
```

先判断面对的是哪种情况:

| 信号 | 情况 |
|---|---|
| 目录不存在或为空 | 全新项目,Phase 1 走开放式审问 |
| 有 README / 代码 / 笔记,但没有骨架文件 | **有上下文**,先采集,Phase 1 走确认式 |
| 已有 `AGENTS.md` / `CLAUDE.md` / `.cursorrules` | 已有约定,**不接管**,见失败分支 2 |
| 已有 `STATE.md` / `DECISIONS.md` / `tasks/` | 半成品骨架,走补齐,见失败分支 7 |
| `.git/` 存在 | 仓库根就是工作区根,不要往下钻一层 |

第二种情况跑采集脚本:

```bash
python <bone目录>/scripts/harvest.py --target <目标目录>
```

它只输出原文片段和清单,不做归纳。怎么把片段变成 E1/E2/E3,读 `references/context-harvest.md`。

然后定档,按信号推,把结论和理由一起说给用户听,让他否决:

| 信号 | 档 |
|---|---|
| 单人 + 小项目 + 试验性 + 预计三个月内结束 | `lite` |
| 要沉淀术语与约定、需要人设偏移、多人协作前先单人跑 | `full` |
| 说不上来 | `full`(超集,之后跑 `--profile lite` 也不会删文件,反向升级才有成本) |

> 🔴 **CHECKPOINT · 目标目录确认前不写盘。** 写错地方比不写更糟——你会留下一个没人知道该不该删的目录。
>
> 🛑 **STOP:** 拿到用户对「目录 + 档位」的明确答复,再进 Phase 1。

### Phase 1 审问(核心字段的来源)

按 Phase 0 的结论分两条路:

| 情况 | 怎么问 | 读哪份 |
|---|---|---|
| 空目录,无任何上下文 | 开放式问,每问带推荐答案 | `references/interview-questions.md` |
| 已有 README / 代码 / 笔记 | E1 直接引用确认,E2 给推断 + 依据,E3 开放式问 | `references/context-harvest.md` |

不管走哪条路,六个问题都要有答案,其中 **Q4「怎么算成功」和 Q5「明确不做什么」永远要问**——这两项几乎不出现在任何文档里,而它们决定骨架有没有用。

四条不可让的规则:

1. **事实自己查** —— 技术栈、目录结构、依赖版本,能读配置得到的不要问
2. **不接受「你定」** —— 给两个选项和各自代价,逼一个二选一;仍不选就留 `___`。留空会被看见,编造不会
3. **E2 不进文件** —— 推断只能出现在问题里,不能出现在 `PROJECT.md` 里
4. **冲突不裁决** —— 两处证据打架时列出双方出处,让用户选。自己挑"更新的那个",猜错代价是整份定义

> 🔴 **CHECKPOINT · 汇总确认前不写盘。** 这一轮的返工成本远低于写完之后改。
>
> 🛑 **STOP:** 把六个答案复述一遍,等用户说「对」,再进 Phase 2。

### Phase 2 生成

先干跑,看要动哪些文件:

```bash
python <bone目录>/scripts/init.py --target <目标目录> --profile <full|lite> --dry-run
```

确认没问题再去掉 `--dry-run`。写入规则是幂等的:

| 目标状态 | 动作 |
|---|---|
| 文件不存在 | 创建 |
| 已存在且内容与模板一致 | 跳过,不报告 |
| 已存在但内容不同 | **跳过**,把差异列给你看 |
| 用户明确要求覆盖 | 才可写,且先备份到 `.bone/backup-<时间戳>/` |

脚本只复制结构,不填内容。用 Phase 1 的结论填这四处:

1. **`PROJECT.md`** —— Q1 一句话、Q4 目标、Q5「不做」、Q3 关键约束
2. **`STATE.md`** —— 阶段写「骨架已建(未验证)」,下一步写 Q6,日期写今天
3. **`CONVENTIONS.md`** —— 技术栈填真实命令(`pytest -q`,不是「用 Python」)。有旧骨架时,把旧 `CONVENTIONS.md` 的技术栈**迁过来**,不是重写
4. **`DECISIONS.md`** —— 审问中用户做的每个选择各写一条;E1 来源的写「原文见 `<文件>:<行>`」

**理由栏只填用户说过的。** 填推测的理由等于伪造依据,半年后有人据此推翻它,会发现依据根本不存在。

### Phase 3 体检

```bash
python <bone目录>/scripts/check.py --target <目标目录> --profile <full|lite>
```

10 项,每项一个结论:PASS / TODO / WARN / FAIL。**档位要和生成时一致**——用 `full` 检查 `lite` 骨架会报 3 个「文件缺失」,那是误报。按结果分派责任:

| 结果 | 谁负责 | 动作 |
|---|---|---|
| FAIL(文件缺失、结构小节缺失) | bone | 直接补,补完重跑 |
| TODO(占位符未填) | 用户 | **列成清单交出去,不代填** |
| WARN(状态超 7 天、下一步超 3 条) | 用户 | 报告,不动 |

最终交付一张表,分两栏:**已生成什么** / **还需要你填什么**。第二栏是重点——骨架的价值不在于文件建齐,而在于那几项填完之后新会话能直接接手。

## 规则表

| 场景 | 必做 | 反模式 |
|---|---|---|
| 核心字段 | 来自用户回答,或 E1 原文 | 按常见情况推断后写进 `PROJECT.md` |
| E2 推断 | 只放进问题里,等确认 | 觉得"很明显"就直接写 |
| 证据出处 | 精确到文件:行 | 「综合 README 与代码分析」 |
| 事实(技术栈、目录) | 自己探测 | 问用户「你用的什么框架」 |
| 用户说「你定」 | 给两个选项 + 代价 | 自己选一个填上 |
| 证据冲突 | 双方出处并列,用户选 | 挑"更权威"的那个 |
| 已有骨架 | 补齐缺失的,迁移已有内容 | 推平重建 |
| 目标目录 | 用户给定,或明确同意用当前目录 | 默认写到 cwd、家目录、`C:\` 下 |
| 已存在的文件 | 跳过 + 列差异,等授权 | 覆盖,或「顺手统一格式」 |
| 体检结论 | 逐条 PASS/TODO/WARN/FAIL | 「基本合格」「大致没问题」 |
| 删除 | 永不执行 | 清理「多余的」用户文件 |

**类型是客观的,大小是主观的。** 冲突只按「新增 / 替换 / 删除」判,不按「哪个更重要」判——后者不可执行。

## 失败分支

每条三段:**触发条件 → 一线修复 → 仍失败兜底**。只做第一段就停下,等于把问题退回给用户。

| # | 触发条件 | 一线修复 | 仍失败兜底 |
|---|---|---|---|
| 1 | 目标目录未给或不明确 | 问一次,给候选(当前目录 / 上一级) | 用户也说不清 → 停在 Phase 0,把探测结果给他指 |
| 2 | 已有 `AGENTS.md` 但无 `bone:` 字段 | 不接管、不覆盖,只输出差异摘要 | 用户坚持纳管 → 备份为 `.bak.<时间戳>` 后再生成,需明确授权 |
| 3 | 两处证据互相矛盾(README vs 代码/依赖) | 并列两条出处,问哪个是当前的 | 用户也裁不了 → 两处都写进 `PROJECT.md` 并标 `TODO:`,不选 |
| 4 | 文件 > 2000 或文档 > 6 | 只读顶层 README 与 `docs/` 前几个 | 仍读不完 → 只读 README 前 20 行 + manifest,其余不看 |
| 5 | 用户要求跳过审问(「先建个空的」) | 生成结构,核心字段留 `___` | 之后也不补 → 报告里写「骨架可用但为空壳」,不当作已完成 |
| 6 | `python` 不可用 | 读 `assets/CHECKLIST.md`,手工建 + 人工体检 | 无写权限 → 输出清单让用户自己建,停在报告 |
| 7 | 已有半成品骨架(`STATE.md` / `tasks/`) | 只补缺失文件、只跑 check,不跑 init、不重走审问 | 新旧结构差异过大且无法映射 → 不迁移,新旧并存,在 `STATE.md` 记一条 |
| 8 | `assets/templates/` 缺失 | 按 `CHECKLIST.md` 手工建 | 清单也读不到 → 安装损坏,让用户重装,不凭记忆重建 |
| 9 | 轻量档要升级到完整档 | `init.py --profile full` 补 3 个缺失文件 | `AGENTS.md` 会报差异(少 3 行地图)→ 确认后 `--force`(先备份)或手工补那 3 行 |

## 资源加载指引

- `references/interview-questions.md` —— **Phase 1、目标目录为空时读**。6 个开放式问法、合格判据、「你定」的接法
- `references/context-harvest.md` —— **Phase 1、目录里已有内容时读**。E1/E2/E3 判据、确认式问法、冲突处理、落盘规则
- `assets/templates/` —— Phase 2 的写入源。`init.py` 自动消费;手工兜底时按目录结构逐个复制
- `scripts/harvest.py` —— Phase 0 执行,目录里已有内容时跑。只采集原文,不归纳,不写盘
- `scripts/init.py` —— Phase 2 执行。幂等复制 + 差异报告,唯一会写盘的脚本。`--profile full|lite`
- `scripts/check.py` —— Phase 3 执行。10 项体检,只读不写。`--profile` 必须与生成时一致
- `assets/CHECKLIST.md` —— **仅当 python 不可用**时读。替代三个脚本,11 文件清单 + 10 项人工检查

## 反模式

- 给一个单人两天就结束的小项目建 11 个文件 —— 那正是「流程太重,跑一次就懒得跑」的起点
- 生成用 `lite`、体检用 `full` —— 3 个误报的「文件缺失」会盖住真正的问题
- 读完 README 觉得"已经很清楚了",跳过 Q4、Q5 —— 这两项永远不写在文档里
- 从 `package.json` 的 `name` 推出项目目标,直接写进 `PROJECT.md` —— E2 当 E1 用
- 虚构出处:「综合 README 与代码结构分析得出」——下一个会话没法回去核对
- 把自己的上一轮推测说成"你之前提到过"——伪造对话上下文,性质等同编造
- 两处证据冲突时默默采用代码 —— 没有出处能解释你为什么这么选
- 目录里有 `STATE.md` 却从零重建,把半个骨架推平
- 把 `harvest.py` 的输出整段贴给用户 —— 他要的是结论和确认,不是原始片段
- 全量读仓库找"感觉"——读得越多,越容易在没有证据的地方看出点什么
- 自己编 `PROJECT.md` 的目标,然后称其为「初稿」
- 用户说「你定」就真的自己定了
- 体检报告写「基本合格」——不可判定的结论等于没检查

## 自检

交付前逐条对照,全部可判定:

- [ ] 目标目录是用户给的,不是猜的
- [ ] 档位(full/lite)与目录性质匹配,且生成与体检用的是同一档
- [ ] 两个 🔴 CHECKPOINT 都发生在写盘动作之前,不是写在后面补的
- [ ] 目录里已有内容时,跑过 `harvest.py`,没跳过采集
- [ ] `PROJECT.md` 里每一句核心字段都能追到用户的某次回答,或某条 E1 原文
- [ ] 没有把 E2 推断写进文件(逐条回看:这句是原文里的,还是我推的)
- [ ] Q4、Q5 都被问过,即使上下文看起来很完整
- [ ] 出现过的证据冲突都列给了用户,没有自己裁决
- [ ] `DECISIONS.md` 的「理由」栏没有一句是模型推测的
- [ ] 11 个文件全部存在(`ls` 数一遍,不凭印象)
- [ ] `check.py` 输出里 FAIL 数量为 0
- [ ] 报告分成了「已生成」和「还需要你填」两栏
- [ ] 有半成品骨架时,是补齐而非重建
- [ ] 第二次跑 init 时零写入(验证幂等的唯一方法)
Files in this package (5)
  • .gitattributes 1 KB
  • .gitignore 1 KB
  • LICENSE 1 KB
  • README.md 8 KB
  • SKILL.md 15 KB

Versions

The database has no other skills named bone.

Database snapshot: 13.11.2026 · package version 2fd0e85de3a6 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100moqian-project-scaffold
    基于陌阡AI工程治理模板(GitHub 仓库 zhaoxuejie/moqian-ai-template)为新项目一键初始化工程骨架。当用户要求新建或初始化一个项目、拉取工程模板、生成项目目录骨架、从模板复制一套 README/PRD/架构/接口契约/任务卡/CI 结构、准备 AI 项目工程目录,或给出项目名和本地路径要求把骨架准备好并清理示例任务卡时使用。覆盖 AI Agent、LLM 应用等新项目 0 到 1 的工程目录搭建;不用于已有项目的业务代码开发。
  • 90task-execution-framework
    中大型任务执行纪律:先定义"做成什么样",再找参照,再规划,最后动手,做完对照规划验收。 含任务分级(S/M/L/XL)、8 步流程、G0/G1/G2 闸门、任务卡/一页规划/验收矩阵、变更三级、交付前 12 项。 Use when 任务超过 30 分钟、跨多章节/多文件/多系统、涉及视觉/数据/发布;或用户说"做看板/报告/网站/方案"、 "改版"、"重做"、"整理成体系";或发现自己反复返工、被连续否决。 Do NOT use when 单点查询、一句话改写、简单命令、纯事实问答。
  • 100skeleton
    Edit skeleton bone transforms/hierarchy, retargeting modes, curve metadata, blend profiles, bone constraints, and learn constraints from animations (VibeUE SkeletonService). Socket CRUD, bone enumeration, physics-asset, and material/LOD inspection are owned by the engine…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.