CoreSpec Skill

保留用户原话，解释设计选择，维护实际系统 Spec。

每次变更只默认创建两份文档：

spec.md    原始需求、用户后续决定、简要分析、当前有效要求
design.md  当前方案、重要决策、实际影响、收尾核对

任务由 Agent 自行拆解和管理；不再创建任务清单或独立验证报告。必要的代码检查、测试与运行观察仍应进行，重要结论直接记在设计中。

使用

将整个 corespec/ 文件夹放进 Agent 的普通 skills 目录，无安装器。向 Agent 描述需求即可，例如：

使用 CoreSpec。需求记录放到 /data/specs/my-project。增加批量导出，保留旧 API 兼容；内部实现由你决定。

Agent 记录原话、分析代码、选择方案并实施。技术选择可以直接调整；改变用户要求的取舍必须先由用户决定。

收尾产物

完成开发后，Agent 把 design.md 改为实际落地的设计，在末尾写简短核对结论，再把受影响模块完整 Spec 合入：

<spec-dir>/spec/index.md
<spec-dir>/spec/modules/<module-path>/spec.md

原来的有效要求、架构和来源不会因为本次变更而被丢弃。当前 Spec 描述整个模块，不是本次变更摘要；详细需求和决策保存在 archive 中，模块通过可读名称引用。

完整原则和工作流见 SKILL.md，命令见 references/storage.md。

Skill 结构

corespec/
├── SKILL.md
├── README.md
├── LICENSE
├── scripts/
│   ├── corespec.py
│   └── test_corespec.py
└── references/
    ├── storage.md
    ├── rules/
    │   ├── 01-spec.md
    │   ├── 02-design.md
    │   └── 03-implementation-and-archive.md
    └── templates/
        ├── spec.md
        ├── design.md
        ├── module-spec.md
        ├── system-index.md
        └── history.md

辅助脚本只使用 Python 标准库，需要 Python 3.10 或更新版本。自测：

python <skill-root>/scripts/test_corespec.py

从四文档版继续工作

已有完整模块 Spec、目录映射和原文哈希可以继续使用。新 change 只创建两份文档。已有活动 change 按以下方式收敛：

• 保留 spec.md 原文和所有用户决定，不重新基线化来掩盖变化。
• 把最终设计整理到 design.md，追加 Final Reconciliation；旧的 Architecture and Design 章节可继续使用。
• 阅读旧验证记录中的失败和未确认事项，不能因换版而忽略。真正解决后才标记 Reconciled。
• 已有 task.md、verification.md 可以作为历史附件保留；脚本不再要求或检查它们，也不会在归档时丢弃这些材料。已有 archive 不改写。

Reconciled 是 Agent 已进行收尾核对的记录，不是测试通过的机器证明。脚本成功只能说明文档与合入结构符合规则。