SuperAPI AI 工具集

cs-feat-ff

设计与创作

查看项目

更新于 10-15 20:30

技能介绍

用途:面向小到不值得走完整 design 的需求。该技能不改变 AI 直接动手的流程,只要求在动手前按需检索项目中已沉淀的 CodeStable 知识,动手后回写一份最简 ff-note,让工作可追溯并被 cs-req / cs-domain backfill 看到、纳入 scoped-commit。

启动前先执行 CodeStable preflight:读 .codestable/attention.md;缺失先 cs-onboard;不用外部 AI 入口替代。

动手前:Glob .codestable/ 查看可用文档,按需取用 requirements/CONTEXT.md 术语、requirements/adrs/ 已拍板架构决策(改跨模块前 grep 相关 ADR)、compound/ 沉淀坑点与技巧(grep -r "关键词" .codestable/compound/)、requirements/{slug}.md 边界、features/ 同类 design、reference/ 共享约定与工具。

执行 gate:改代码前运行 python3 .codestable/tools/codestable-worktree-gate.py --root . --json start --unit .codestable/features/YYYY-MM-DD-{slug};ff-note 落盘、收尾提交前运行同名脚本的 commit 子命令。gate 不通过不开始改代码,用户批准 override 时先在 unit 目录写 worktree-override.md。

编码约束:先判断代码放哪儿;扫一眼待改文件现状;只写用户明确要的最少代码,不加“以后可能用”的配置、抽象、防御性兜底与未提的边界处理;只动该动的函数;新逻辑默认放新文件;不打补丁分支;出现往超 300 行文件追加、往超 10 个方法的类加方法、重复代码、参数到第 4 个、往 utils/helpers 堆东西等反射信号就停。

收尾:代码与验证完成、用户确认后回写 .codestable/features/YYYY-MM-DD-{slug}/{slug}-ff-note.md,含做了什么、改了哪些、怎么验证、顺手发现(可选)四节,保持精简。slug 由 AI 从用户请求抽 2-4 个 kebab-case 英文词,不询问用户。提交范围为本轮代码改动加 ff-note;进入 cs-code-review 做独立 diff 评审,Critical/Important 未清零不进 commit;经用户明确同意后执行 scoped-commit。

跳出条件:涉及 3 个以上子系统、需引入或冲突新术语、要打破既定模块边界 ADR、用户追加要求使范围翻倍,应停下并建议切回 cs-feat-design。限制:不写 design doc/checklist/acceptance,不预先与用户确认方案,不在 .codestable/ 留 ff-note 之外的新文件;具体工具安装与 branch-guard hook 说明见资料中指向的 reference 文件。