ab300819/keel
keel 文档驱动开发流程(需求→设计→测试→开发→验证)+ 配套质量 / 测试 / 重构 skill
用户要求对计划、设计或代码进行外部独立审查、对抗审查或 second opinion 时使用。 内部自检用 verify;代码规范检查用 code-quality。
创建、同步或精简项目 AGENTS.md / CLAUDE.md。用于维护代理指令与项目记忆;模块自描述用 code-self-describe。
管理 keel 中暂缓但需追踪的事项:登记、查询、重新激活或关闭。不用于 Jira/Linear 或 Sprint 容量管理。
为 keel 的 01 需求和 02 设计创建交互评审面板,并按用户意见回写文档。不用于代码或 PRD 评审。
修复 keel 项目的缺陷并维护回归证据。非 keel 项目修复用 dev-flow。
编写或审查代码时提供 MTE、命名、注释、日志与可维护性指导。系统性重构执行用 refactor。
创建、更新或审计模块级 CLAUDE.md 与源文件 INPUT/OUTPUT/POS 描述,帮助导航代码。项目根记忆维护用 agent-memory。
分析已有代码库的系统边界、模块、接口与技术约束,生成盘点报告而不修改代码。建立 keel 基线用 retrofit。
Git 提交信息规范。着重于提交信息的格式化、风格统一。优先学习并沿用项目已有的提交历史风格,若无明显风格或为新项目,则遵循 Conventional Commits 规范。
从已完成的 keel 开发周期提取可复用经验、模式和决策。同步实施进度用 sync。
在非 keel 项目中,按任务、Issue 或已有计划实现功能与修复问题。keel 任务执行用 dev-workflow。
把 keel 系统设计拆为有依赖、验收标准和追溯关系的开发任务。执行任务用 dev-workflow。
执行或恢复 keel 开发任务,支持单项、批量和明确授权的无人值守。任务拆分用 dev-tasks;非 keel 开发用 dev-flow。
撰写或审阅技术文档时,处理结构、信息归属、重复结论和缺少上下文的问题。仅检查 Markdown 标记与排版用 markdown-style。
为已有 keel 项目追加或迭代功能,更新需求、设计、测试与任务。修复缺陷用 bugfix。
Git 操作安全与规范。强制要求使用 git 原生命令处理受控文件,防止丢失索引或产生冗余变更。当 Agent 尝试移动、重命名或删除文件时触发。
将外部参考、调研或评审发现转为 keel 项目的改进事项。普通资料研究不使用此流程。
读取或更新项目上下文摘要,用于交接、接手项目或切换 AI 工具。建立 keel 基线用 retrofit。
选择并编排 keel 的初始化、功能、修复、验证、收尾、洞察、设计与规范升级流程。仅用于 keel 工作;已指定原子 skill 时直接使用它。
将模糊产品想法或大型 PRD 整理为可供 keel 消费的需求,选择探索或解析路径。已明确需求编码用 requirements。
探索模糊产品想法或澄清 PRD 片段,形成结构化需求。拆分大型 PRD 用 prd-parser。
拆分大型 PRD 文档、PDF 或截图,保留原文并建立 FR/NFR 分类。需求澄清用 prd-brainstorm。
执行现有代码的结构性重构或技术债改造,并验证行为保持一致。一般代码规范审查用 code-quality。
把已明确的需求和背景写入 keel 需求文档,建立 F/US/AC 与约束记录。模糊产品想法用 prd。
为已有项目建立 keel 基线,或迁移旧版 keel 文档。只读代码盘点用 codebase-insight;了解项目上下文用 onboard。
按实现进展更新 keel 状态、追溯关系和归档,处理文档与代码漂移。实施正确性审查用 verify。
创建或更新 keel 技术设计:架构、接口、数据模型与变更影响。需求定义用 requirements;视觉设计用 ui-orchestrator。
依据 keel 需求设计可追溯的 UT/IT/E2E 用例文档。编写测试代码用 testing-guide;运行套件用 test-run。
运行 keel 项目的测试套件并生成报告,检查受影响测试与追溯覆盖。对运行中系统做黑盒实测用 e2e-test-flow。
编写或审查测试代码时,指导断言、Mock、分支覆盖和测试有效性。设计 keel 用例文档用 test-cases。
进行 UI/UX 设计、界面开发或设计系统工作时,选择适用的专门 skill。
验证 keel 的文档一致性、实现正确性、UI 对齐或开发就绪状态。更新文档与任务进度用 sync。
检查或维护代码与文档的工作区布局声明(inline/shell/linked),或迁移为子模块布局。适用于代码根、外部仓库引用与分仓需求。