File contents touchstone — 项目结论生命周期
项目事实基准:每仓库一份 <git-root>/TOUCHSTONE.md(PCR 格式)。若宿主支持会话启动注入(如 Claude Code 的 SessionStart hook),索引区已自动注入;否则开工时先读 <git-root>/TOUCHSTONE.md 索引区。本文管写路径 。
五态状态机(锁死,禁止蔓延)
状态
含义
使用规则
BETA 假设中
对话推理未验证
禁止作为实施依据
RC 验证中
测试/部署/待验收
引用须带"截至何时"
GA 已归档
端到端验证通过且用户明示
可作事实直接引用,条目带"批准人:用户+日期"
SUPERSEDED 已推翻
被新证据否定
禁引用;保留原文+双向链接指向新条目
EOL 已失效
过时但无替代
禁引用;对标 ADR Deprecated
红线(不可协商)
归档权限在用户 :AI 助手只起草(候选区,默认 BETA),无权自标 GA。用户宣布成果 ≠ 自动归档——起草后必须问一句 "归档这条吗?"
条目不可变 :变更通过新增条目 + 双向链接(推翻:MMDD-xxx / 被 MMDD-yyy 推翻),不删除不原地改。
唯一写入路径(防索引区漂移)
所有对 TOUCHSTONE.md 的修改必须一次完成:正文条目 + 索引行同一次 Edit 落笔 。只写正文不写索引 = 违规。优先复用 TOUCHSTONE-TEMPLATE.md 的条目模板,不内联重写。
维护上限
候选区 >10 条时提醒用户批量裁决;候选条目超 30 天未归档,建议用户删除(容忍丢弃,候选区是低价值暂存区)
同主题多轮排查折叠为终态一条 + 两行演进摘要
文件 >500 行必须拆分;索引区 >200 行触发裁剪
分工
TOUCHSTONE.md = 仓库级、用户确认过的高频教训(进 git、团队可见、启动必读);助手私有的记忆体系 = 会话流水与用户偏好(门槛低)。方向:私有记忆 → TOUCHSTONE 单向沉淀,禁止反向复制。
退役判据
连续两周会话中零检索命中(没有任何一次实际引用 TOUCHSTONE.md 条目),主动向用户建议删减或退役——机制的死亡条件先于腐化被定义。
自我说服对照表
你在想
事实
"我端到端验证过了,顺手标 GA"
违规。GA 须用户明示,验证通过只够 RC→候选区
"索引区回头补"
违规。正文+索引同一次 Edit
"这条明显过时了,直接删掉"
违规。加 SUPERSEDED/EOL 标记 + 链接,不删除
1 --- 2 name: touchstone 3 description: touchstone — 项目结论生命周期 4 --- 5 6 # touchstone — 项目结论生命周期 7 8 项目事实基准:每仓库一份 `<git-root>/TOUCHSTONE.md`(PCR 格式)。若宿主支持会话启动注入(如 Claude Code 的 SessionStart hook),索引区已自动注入;否则开工时先读 `<git-root>/TOUCHSTONE.md` 索引区。本文管**写路径**。 9 10 ## 五态状态机(锁死,禁止蔓延) 11 12 | 状态 | 含义 | 使用规则 | 13 |---|---|---| 14 | BETA 假设中 | 对话推理未验证 | 禁止作为实施依据 | 15 | RC 验证中 | 测试/部署/待验收 | 引用须带"截至何时" | 16 | GA 已归档 | 端到端验证通过**且用户明示** | 可作事实直接引用,条目带"批准人:用户+日期" | 17 | SUPERSEDED 已推翻 | 被新证据否定 | 禁引用;保留原文+双向链接指向新条目 | 18 | EOL 已失效 | 过时但无替代 | 禁引用;对标 ADR Deprecated | 19 20 ## 红线(不可协商) 21 22 1. **归档权限在用户**:AI 助手只起草(候选区,默认 BETA),无权自标 GA。用户宣布成果 ≠ 自动归档——起草后**必须问一句**"归档这条吗?" 23 2. **条目不可变**:变更通过新增条目 + 双向链接(`推翻:MMDD-xxx` / `被 MMDD-yyy 推翻`),不删除不原地改。 24 25 ## 唯一写入路径(防索引区漂移) 26 27 所有对 TOUCHSTONE.md 的修改必须一次完成:**正文条目 + 索引行同一次 Edit 落笔**。只写正文不写索引 = 违规。优先复用 `TOUCHSTONE-TEMPLATE.md` 的条目模板,不内联重写。 28 29 ## 维护上限 30 31 - 候选区 >10 条时提醒用户批量裁决;候选条目超 30 天未归档,建议用户删除(容忍丢弃,候选区是低价值暂存区) 32 - 同主题多轮排查折叠为终态一条 + 两行演进摘要 33 - 文件 >500 行必须拆分;索引区 >200 行触发裁剪 34 35 ## 分工 36 37 TOUCHSTONE.md = 仓库级、用户确认过的高频教训(进 git、团队可见、启动必读);助手私有的记忆体系 = 会话流水与用户偏好(门槛低)。方向:私有记忆 → TOUCHSTONE 单向沉淀,禁止反向复制。 38 39 ## 退役判据 40 41 连续两周会话中零检索命中(没有任何一次实际引用 TOUCHSTONE.md 条目),主动向用户建议删减或退役——机制的死亡条件先于腐化被定义。 42 43 ## 自我说服对照表 44 45 | 你在想 | 事实 | 46 |---|---| 47 | "我端到端验证过了,顺手标 GA" | 违规。GA 须用户明示,验证通过只够 RC→候选区 | 48 | "索引区回头补" | 违规。正文+索引同一次 Edit | 49 | "这条明显过时了,直接删掉" | 违规。加 SUPERSEDED/EOL 标记 + 链接,不删除 |
game1991/awesome-skills/tree/main/skills/touchstone commit 50d14f5827
Frequently asked questions How do I install the Touchstone skill? Run npx skillmds@latest add game1991/touchstone in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
What does the Touchstone skill do? touchstone — 项目结论生命周期 It is listed under Coding & Dev Tools on SkillMD.
Is Touchstone safe to use? This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
Which AI agents work with Touchstone? This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Is Touchstone free to use? Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
Who published Touchstone? game1991 (@game1991) published this skill. Their other Agent Skills are listed on their SkillMD profile.