Community写作与编辑github.com

dofastted/AgentDock

在开始实施前发现并注入特定项目的编码指南。读取 .trellis/spec/ 中的规范索引、开发前检查清单和共享思维指南。适用于启动新编码任务、编写任何代码之前、切换到不同包或需要刷新项目约定和标准时。

AgentDock 是什么?

AgentDock 是一个 AI 智能体技能,专为需要在项目特定编码指南指导下工作的开发者设计。它通过在编码前自动发现并注入 `.trellis/spec/` 中的规范,确保开发过程符合项目标准。该技能支持任何能执行 shell 命令的 AI 代理平台(如 Claude Code、Codex 等),其工作流程包括:首先读取任务工件(prd.md、design.md、implement.md),然后使用 Python 脚本发现相关包及其规范层,接着根据任务类型(后端、前端、单元测试等)识别适用的规范,读取规范索引及其指向的具体指南文件(如错误处理、约定、模拟策略),并始终读取共享指南。对于非平凡任务,还需在编码前明确变更边界。通过强制实施这些步骤,AgentDock 帮助开发者避免偏离项目约定,减少代码审查中的摩擦,并确保跨包的一致性。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/dofastted/AgentDock/tree/HEAD/.claude/skills/trellis-before-dev

Installed? Explore more 写作与编辑 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

在开始任务之前,请阅读相关的开发指南。

执行以下步骤:

  1. 读取当前任务工件:

    • prd.md 获取需求和验收标准
    • 如果存在 design.md,获取技术设计
    • 如果存在 implement.md,获取执行顺序和验证计划
  2. 发现包及其规范层:

    python3 ./.trellis/scripts/get_context.py --mode packages
    
  3. 确定哪些规范适用于您的任务,依据:

    • 您正在修改的包(例如,cli/、docs-site/)
    • 工作类型(后端、前端、单元测试、文档等)
    • 任务工件引用的任何规范/研究路径
  4. 读取每个相关模块的规范索引:

    cat .trellis/spec/<package>/<layer>/index.md
    

    遵循索引中的 “开发前检查清单” 部分。

  5. 读取开发前检查清单中列出且与您的任务相关的具体指南文件。索引本身不是目标——它指向实际的指南文件(例如 error-handling.md、conventions.md、mock-strategies.md)。阅读这些文件以了解编码标准和模式。

  6. 始终阅读共享指南:

    cat .trellis/spec/guides/index.md
    
  7. 对于非普通任务,在编写代码之前说明变更边界。非普通任务是指触及多个文件、跨越层级、更改公共接口或修改您并非刚刚编写的代码的任务。写下:

    • 当前行为和期望行为之间的最小差距
    • 该行为实际所在的位置(而不是最容易拦截的位置)
    • 您预计要更改哪些文件,以及每个文件更改的必要原因
    • 您明确不在此任务中做什么
    • 如果需要进行本地重构,您将如何证明它未改变行为

    一个范围较小且明确定义的变更不需要此步骤——直接执行即可。

    如果实际范围明显大于此,请在继续之前说明原因。不要自行扩大变更范围。

  8. 了解您需要遵循的编码标准和模式,然后进行您的开发计划。

此步骤在编写任何代码之前 是强制性的。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

相关技能