Skip to content

Commit 8b0f2f0

Browse files
authored
optimize: cc cmd (#150)
1 parent edc5e25 commit 8b0f2f0

File tree

20 files changed

+119
-70
lines changed

20 files changed

+119
-70
lines changed

README.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -62,7 +62,7 @@ Once setup, you can start coding with Claude Code:
6262

6363
### AST-Driven Coding Workflow
6464

65-
[`.claude/hooks`](internal/utils/assets/.claude/hooks) provide a 4-layer analysis chain from repository to node details:
65+
[`.claude/hooks`](internal/cmd/assets/.claude/hooks) provide a 4-layer analysis chain from repository to node details:
6666

6767
```
6868
list_repos → get_repo_structure → get_package_structure → get_file_structure → get_ast_node
@@ -72,13 +72,13 @@ list_repos → get_repo_structure → get_package_structure → get_file_structu
7272

7373
### Claude Code Slash Commands
7474

75-
[`.claude/commands`](internal/utils/assets/.claude/commands) provide three custom slash commands to streamline development:
75+
[`.claude/commands`](internal/cmd/assets/.claude/commands) provide three custom slash commands to streamline development:
7676

7777
| Command | Function | Description |
7878
|---------|----------|-------------|
79-
| [`/abcoder:schedule` <task_desc>](internal/utils/assets/.claude/commands/schedule.md) | Design implementation | Analyze codebase by using ABCoder, design technical solution |
80-
| [`/abcoder:task <name>`](internal/utils/assets/.claude/commands/task.md) | Create coding task | Generate standardized CODE_TASK document |
81-
| [`/abcoder:recheck <task>`](internal/utils/assets/.claude/commands/recheck.md) | Verify solution | Critically check CODE_TASK feasibility, useful when a CODE_TASK contains external dependencies |
79+
| [`/abcoder:schedule` <task_desc>](internal/cmd/assets/.claude/commands/abcoder/schedule.md) | Design implementation | Analyze codebase by using ABCoder, design technical solution |
80+
| [`/abcoder:task <name>`](internal/cmd/assets/.claude/commands/abcoder/task.md) | Create coding task | Generate standardized CODE_TASK document |
81+
| [`/abcoder:recheck <task>`](internal/cmd/assets/.claude/commands/abcoder/recheck.md) | Verify solution | Critically check CODE_TASK feasibility, useful when a CODE_TASK contains external dependencies |
8282

8383
### Workflow
8484

@@ -102,11 +102,11 @@ Start coding(sub-agent) ─────────→ Execute Implementation
102102

103103
| File | Purpose |
104104
|------|---------|
105-
| [`CLAUDE.md`](internal/utils/assets/.claude/CLAUDE.md) | Core AST-Driven Coder role definition |
106-
| [`settings.json`](internal/utils/assets/.claude/settings.json) | Hooks and permissions configuration |
107-
| [`hooks/`](internal/utils/assets/.claude/hooks/) | Automation scripts (parse/prompt/reminder) |
108-
| [`commands/`](internal/utils/assets/.claude/commands/) | Slash command definitions (abcoder:task/abcoder:schedule/abcoder:recheck) |
109-
| [`tmpls/ABCODER_CODE_TASK.md`](internal/utils/assets/.claude/tmpls/ABCODER_CODE_TASK.md) | Coding task template |
105+
| [`CLAUDE.md`](internal/cmd/assets/.claude/CLAUDE.md) | Core AST-Driven Coder role definition |
106+
| [`settings.json`](internal/cmd/assets/.claude/settings.json) | Hooks and permissions configuration |
107+
| [`hooks/`](internal/cmd/assets/.claude/hooks/) | Automation scripts (parse/prompt/reminder) |
108+
| [`commands/`](internal/cmd/assets/.claude/commands/) | Slash command definitions (abcoder:task/abcoder:schedule/abcoder:recheck) |
109+
| [`tmpls/ABCODER_CODE_TASK.md`](internal/cmd/assets/.claude/tmpls/ABCODER_CODE_TASK.md) | Coding task template |
110110

111111
### Dependencies
112112

docs/claude-code-spec.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -123,5 +123,5 @@ coding-executor ──────→ 执行实现
123123

124124
## 相关文档
125125

126-
- [hooks/README.md](../internal/utils/assets/.claude/hooks/README.md) - 钩子系统详解
127-
- [commands/README.md](../internal/utils/assets/.claude/commands/README.md) - 斜杠命令详解
126+
- [hooks/README.md](../internal/cmd/assets/.claude/hooks/README.md) - 钩子系统详解
127+
- [commands/README.md](../internal/cmd/assets/.claude/commands/README.md) - 斜杠命令详解
File renamed without changes.
Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
---
2+
name: ABCoder: Recheck
3+
description: Validate CODE_TASK technical feasibility with critical analysis using mcp__abcoder.
4+
category: ABCoder
5+
tags: [abcoder, recheck, validation]
6+
---
7+
从原始需求出发,使用 mcp__abcoder 进行批判性分析,以验证 CODE_TASK 的技术可行性。
8+
9+
<!-- ABCODER:START -->
10+
**Guardrails**
11+
- 批判性思考,保持诚实:确保方案可实现需求、无技术风险、最大化复用已有功能、最小化改动。
12+
- 严格使用 `mcp__abcoder` 验证技术细节,禁止假设。
13+
- 下钻到 `mcp__abcoder__get_ast_node` 粒度进行验证。
14+
15+
**Steps**
16+
Track these steps as TODOs and complete them one by one.
17+
1.`mcp__abcoder__get_repo_structure` 开始,获取目标仓库结构。
18+
2. 定位相关的 package 和 node。
19+
3. 使用 `mcp__abcoder__get_ast_node` 深入分析相关代码节点,验证方案的可行性。
20+
4. 检查方案是否可以实现 CODE_TASK 中的所有需求。
21+
5. 识别并报告任何潜在的技术风险。
22+
6. 验证是否最大化复用了已有功能,是否最小化了改动。
23+
7. 如发现问题,提出具体的修改建议或后续问题。
24+
8. 总结分析结果,明确指出方案是否可以执行。
25+
26+
**Reference**
27+
- `mcp__abcoder__list_repos` - 列出所有可用仓库
28+
- `mcp__abcoder__get_repo_structure` - 获取仓库结构(必须作为第一步)
29+
- `mcp__abcoder__get_package_structure` - 获取 package 结构
30+
- `mcp__abcoder__get_file_structure` - 获取文件结构
31+
- `mcp__abcoder__get_ast_node` - 获取 AST 节点详情(下钻验证)
32+
<!-- ABCODER:END -->
Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
---
2+
name: ABCoder: Schedule
3+
description: Design implementation plan using mcp__abcoder analysis and code exploration.
4+
category: ABCoder
5+
tags: [abcoder, schedule, planning]
6+
---
7+
使用mcp__abcoder分析相关仓库(下钻到mcp__abcoder__get_ast_node查看细节),帮助用户设计实现方案。
8+
9+
<!-- ABCODER:START -->
10+
**Guardrails**
11+
- 最大化复用项目已有功能,避免重复造轮子。
12+
- 优先采用直接、最小改动的实现方式,只有在用户明确要求时才增加复杂度。
13+
- 严格限制修改影响面在所请求的结果范围内。
14+
- 找出任何模糊或含糊不清的细节,并在修改文件前提出必要的后续问题。
15+
- 在 Schedule 阶段禁止编写代码,禁止使用 agent。
16+
17+
**Steps**
18+
Track these steps as TODOs and complete them one by one.
19+
1.`mcp__abcoder__get_repo_structure` 开始,获取目标仓库结构。
20+
2. 根据任务描述,定位相关的 package。
21+
3. 使用 `mcp__abcoder__get_package_structure` 获取 package 内的文件和节点列表。
22+
4. 使用 `mcp__abcoder__get_ast_node` 深入分析相关代码节点,理解现有实现模式。
23+
5. 分析依赖关系、调用链、类型信息等。
24+
6. 设计实现方案,确保最大化复用已有功能、最小化改动。
25+
7. 找出任何模糊或缺失的技术细节,并向用户提出后续问题。
26+
8. 输出清晰的技术方案,包括修改范围、涉及的文件、关键实现步骤。
27+
28+
**Reference**
29+
- `mcp__abcoder__list_repos` - 列出所有可用仓库
30+
- `mcp__abcoder__get_repo_structure` - 获取仓库结构(必须作为第一步)
31+
- `mcp__abcoder__get_package_structure` - 获取 package 结构
32+
- `mcp__abcoder__get_file_structure` - 获取文件结构
33+
- `mcp__abcoder__get_ast_node` - 获取 AST 节点详情(下钻分析)
34+
<!-- ABCODER:END -->
Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
---
2+
name: ABCoder: Task
3+
description: Create a SPEC-driven CODE_TASK document from task context.
4+
category: ABCoder
5+
tags: [abcoder, task, creation]
6+
---
7+
根据任务上下文创建一个由 SPEC 驱动的 CODE_TASK 文档。
8+
9+
<!-- ABCODER:START -->
10+
**Guardrails**
11+
- 必须提供任务名称,格式为 `/task <任务名称>`。若未提供,根据任务上下文推荐一个名词(确保清晰、简洁)。
12+
- 文件路径使用 `./task/{{MMDD}}/{{NAME}}__CODE_TASK.md` 格式。
13+
- 严格遵循 CODE_TASK 模板格式和要求。
14+
- 清晰列出所有外部依赖包名称(如有)。
15+
- 创建完成后停止操作,不进行额外工作。
16+
17+
**Steps**
18+
Track these steps as TODOs and complete them one by one.
19+
1. 验证用户提供了任务名称,如未提供则提示使用格式 `/task <任务名称>`
20+
2. 执行 `d=$(date +%m%d) && mkdir -p "./task/$d/"` 创建 `./task/{{MMDD}}/` 目录。
21+
3. 读取模板文件 `/Users/bytedance/github/github.com/cloudwego/abcoder/.claude/tmpls/ABCODER_CODE_TASK.md`
22+
4. 根据任务上下文和名称,按照模板格式填充内容,生成新文件 `./task/{{MMDD}}/{{NAME}}__CODE_TASK.md`
23+
5. 检查并清晰列出 CODE_TASK 包含的外部依赖包(如有)。
24+
6. 验证生成的文件格式正确,包含所有必要字段。
25+
7. 告知用户文件已创建成功,包含文件路径和外部依赖信息(如有),停止操作。
26+
27+
**Reference**
28+
- 模板文件:`/Users/bytedance/github/github.com/cloudwego/abcoder/.claude/tmpls/ABCODER_CODE_TASK.md`
29+
- 示例:
30+
- `/task Feature_Auth` → 创建 `./task/1013/Feature_Auth__CODE_TASK.md`
31+
- `/task Bugfix-Api` → 创建 `./task/1013/Bugfix_Api__CODE_TASK.md`
32+
<!-- ABCODER:END -->
File renamed without changes.

internal/utils/assets/.claude/hooks/abcoder/abcoder-workflow.md renamed to internal/cmd/assets/.claude/hooks/abcoder/abcoder-workflow.md

File renamed without changes.

internal/utils/assets/.claude/hooks/abcoder/need_update.sh renamed to internal/cmd/assets/.claude/hooks/abcoder/need_update.sh

File renamed without changes.

0 commit comments

Comments
 (0)