crd

crd 技能是一种专为现有项目开发（Brownfield Development）设计的协调工具，旨在简化在现有代码库中请求与实施变更的流程。它作为开发者意图与结构化行动任务计划之间的主要桥梁。通过自动化文档编写与影响评估阶段，它能协助工程团队维持清晰的架构边界与一致的项目元数据。

此技能的核心在于管理 Git 历史记录与文档之间的关系。它通过与 PROJECT.md 文件交互，利用哈希值（hashes）追踪代码库状态，确保上下文知识与最新提交保持同步。当用户提出变更需求（例如新增功能、修改现有模块或重构代码）时，该技能会自动触发影响分析，找出受影响的组件，让开发者在开始实施前拥有明确的作业范围。这种主动处理的方法有助于预防技术债，并减少处理复杂代码修改时的认知负担。

• 使用 PROJECT.md 进行自动化上下文知识管理，为现有项目维护最新的说明文档。

• 无缝集成 Git，用于验证存储库状态并通过 Diff 处理上下文更新。

• 支持基于关键词的变更分类（新增功能、修改功能、移除功能、重构），以标准化开发任务。

• 集成影响分析功能，评估建议变更对现有代码结构的潜在连锁反应。

• 交互式需求获取，包含验收标准（Given/When/Then）的生成。

• 自动生成结构化的 CRD Markdown 文件并存储于 docs/crd 目录中。

• 内置支持在开发工作流程中列出与追踪 CRD 的状态。

• 必须指定有效的 Git 存储库作为目标项目路径。

• 适合软件工程师与项目负责人，用于管理需要结构化变更流程的现有项目。

• 作为无状态（stateless）技能运作，所有状态直接保存在项目存储库中（PROJECT.md 与 CRD 文件）。

• 是更大规模 /breakdown 与 /execute 工作流程的基础依赖。

• 建议搭配 /crd-investigate 与 /crd-impact-analysis 使用，以达到完整的生态系覆盖。

• 有助于为企业级功能请求维持清晰的审计轨迹与需求追踪。