kdletters
96b45e6ffc
## 变更 - 建立文档生命周期与现状索引，统一 `current`、`historical`、`review`、开放事项和活动计划边界。 - 为历史/待复核文档补充状态头，将有源码与测试证据的专题纳入当前入口。 - 新增规范驱动开发 skill 与 `check:doc-index` 门禁，并接入 `lint`。 - 合入 `origin/master` 的 AGC 通用插件宿主与 Cocos Creator 编辑器能力，并补充父子规范关系和验收范围。 ## 合并说明 - 合入基线：`origin/master` `4a46f89c9`。 - 合并提交：`259134b59`。 - 合并过程无冲突。 ## 验证 - `npm run check:doc-index` - `npm run check:encoding` - `git diff --check` - `python -X utf8 C:/Users/kdletters/.codex/skills/.system/skill-creator/scripts/quick_validate.py .codex/skills/spec-driven-development` - 推送前 pre-push master 门禁通过。 ## CI 请以本 PR 的 Gitea CI 检查为准；提交后持续关注，失败时按失败 job 继续修复。 Reviewed-on: #339 Co-authored-by: kdletters <kdletters@qq.com> Co-committed-by: kdletters <kdletters@qq.com>
3.1 KiB
3.1 KiB
name, description, license, metadata
| name | description | license | metadata | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| spec-driven-development | 在 Genarrative 中处理跨模块功能、公开 API/DTO、SpacetimeDB schema、AGC/Runtime 或复杂 UI 状态链路时，按主规范、里程碑规范、单里程碑实现计划和验收证据推进；小型局部修复不触发。 | MIT |
|
SDD 规范驱动开发
本 skill 把 Genarrative 的复杂任务路由到规范先行、单里程碑交付的工作流。权威规则和模板分别见：
docs/【协作规范】规范驱动开发工作流-2026-09-12.mddocs/project-memory/shared-memory/【模板】规范驱动开发主规范与里程碑模板-2026-09-12.md
触发条件
使用本 skill 的任务包括：
- 跨前端、
api-server、platform-*、spacetime-client、spacetime-module或module-*的功能。 /api/external/v1、共享 DTO、OpenAPI、SpacetimeDB schema、迁移或跨版本重放合同变化。- AGC / DirectProject、Agent Runtime、工具白名单、审批、持久化恢复或资源工作流变化。
- 复杂 UI 状态链路、入口/页面生命周期变化，或需要多个独立验收面的功能。
文案、单文件局部修复、无行为变化重构和一次性诊断继续使用轻量流程；执行中一旦触及公开行为或跨模块合同，切换到本 skill。
执行要求
- 检查工作树，读取当前专题、源码、测试、契约和历史决策；写清交付结果、验收判据和不做项。
- 找到或更新唯一主规范。主规范描述行为合同、边界、非目标、兼容/迁移和证据，不绑定实现细节。
- 在
docs/project-memory/plans/创建一个或多个【里程碑】中文标题-YYYY-MM-DD.md，填写Version、Status、Date、Parent Spec、范围、依赖和验收标准；评审通过前不写业务代码。 - 每次只选择一个已评审里程碑，创建对应的
【实施计划】中文标题-YYYY-MM-DD.md，明确修改边界、顺序、验证命令、风险和回滚点。 - 发现行为需要变化时，严格按
主规范 → 尚未实现的里程碑规范 → 当前实现计划 → 代码与测试更新。 - 完成一个里程碑后，提供主规范/里程碑逐条对照、自动化验证、必要运行时 smoke、边界验证和未验证项；未验收不得推进下一个里程碑。
- 全部验收通过后，将持久结论合并回主规范，删除已完成的临时计划，并检查文档、契约、测试和提交边界一致。
约束
- 里程碑和实现计划是开发期协调文件，完成或取消后删除；阶段编号和临时名称不得进入产品代码、用户文档、测试名称或提交标题。
- 活动计划可以提交以便团队同步，但不得把一次性实现步骤写进长期规范。
- 继续遵守现有 API、SpacetimeDB、AGC、编码和中文文档约束；本 skill 不替代专题门禁。
- 文档任务至少运行
npm run check:doc-index、npm run check:encoding和git diff --check；代码任务再运行范围匹配的测试、类型检查、schema/OpenAPI 或运行时 smoke。