> 功能说明: 本技能涵盖 完整的参数配置、和输出格式说明、处理场景 等核心能力。
Code 1.0.4
When to Use
User explicitly requests code implementation. Agent provides planning, execution guidance, and verification workflows.
Architecture
User preferences stored in $HOME/code/ when user explicitly requests.
$HOME/code/
- memory.md # User-provided preferences only
Create on first use: mkdir -p $HOME/code
Quick Reference
| Topic | File |
|---|---|
| Memory setup | memory-template.md |
| Task breakdown | planning.md |
| Execution flow | execution.md |
| Verification | verification.md |
| Multi-task state | state.md |
| User criteria | criteria.md |
Scope
This skill ONLY:
- Provides coding workflow guidance
- Stores preferences user explicitly provides in
$HOME/code/ - Reads included reference files
This skill NEVER:
- Executes code automatically
- Makes network requests
- Accesses files outside
$HOME/code/and the user's project - Modifies its own SKILL.md or auxiliary files
- Takes autonomous action without user awareness
Core Rules
1. Check Memory First
Read $HOME/code/memory.md for user's stated preferences if it exists.
2. User Controls Execution
- This skill provides GUIDANCE, not autonomous execution
- User decides when to proceed to next step
- Sub-agent delegation requires user's explicit request
3. Plan Before Code
- Break requests into testable steps
- Each step independently verifiable
- See
planning.mdfor patterns
4. Verify Everything
| After | Do |
|---|---|
| Each function | Suggest running tests |
| UI changes | Suggest taking screenshot |
| Before delivery | Suggest full test suite |
5. Store Preferences on Request
| User says | Action |
|---|---|
| "Remember I prefer X" | Add to memory.md |
| "Never do Y again" | Add to memory.md Never section |
Only store what user explicitly asks to save.
Workflow
Request -> Plan -> Execute -> Verify -> Deliver
Common Traps
- Delivering untested code -> always verify first
- Huge PRs -> break into testable chunks
- Ignoring preferences -> check memory.md first
Self-Modification
This skill NEVER modifies its own SKILL.md or auxiliary files.
User data stored only in $HOME/code/memory.md after explicit request.
External Endpoints
This skill makes NO network requests.
| Endpoint | Data Sent | Purpose |
|---|---|---|
| None | None | N/A |
Security & Privacy
Data that stays local:
- Only preferences user explicitly asks to save
- Stored in
$HOME/code/memory.md
Data that leaves your machine:
- None. This skill makes no network requests.
This skill does NOT:
- Execute code automatically
- Access network or external services
- Access files outside
$HOME/code/and user's project - Take autonomous actions without user awareness
- Delegate to sub-agents without user's explicit request
前置条件
运行环境
- Agent平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
- 操作系统: Windows / macOS / Linux
依赖说明
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|---|---|---|---|
| LLM API | API | 必需 | 由Agent内置LLM提供 |
API Key 配置
- 本Skill基于Markdown指令,无需额外API Key(除内容中明确标注的外部API)
可用性分类
- 分类: MD+execute(纯Markdown指令,部分功能需要exec命令行执行能力)
- 说明: 基于Markdown的AI Skill,通过自然语言指令驱动Agent执行任务
能力范围
- Coding workflow with planning, implementation, verification, and testing
for clean software devel - 触发关键词: planning, code, implementation, workflow, 1
适用范围
| 场景 | 输入 | 输出 |
|---|---|---|
| 基础使用 | 用户请求 | 处理结果 |
不适用于:需要人工判断的复杂决策场景
使用说明
- 确认运行环境满足依赖说明中的要求
- 根据适用场景选择合适的使用方式
- 执行操作并检查输出结果
- 如遇错误,参考错误处理章节
示例
示例1:基础用法
# 请参考上方使用说明进行配置和调用
result = "ready"
异常处置
| 错误场景 | 原因 | 处理方式 |
|---|---|---|
| 配置错误 | 参数缺失或格式错误 | 检查依赖说明中的配置要求 |
| 运行时错误 | 运行环境不满足 | 确认运行环境符合依赖说明 |
| 网络错误 | 连接超时或不可达 | 检查网络连接后重试,参考国内替代方案 |
问答速查
Q1: 如何开始使用Code 1.0.4?
A: 请先阅读使用流程章节,确认环境满足依赖说明中的要求。
Q2: 遇到错误怎么办?
A: 请参考错误处理章节,按照表格中的处理方式操作。
Q3: Code 1.0.4有什么限制?
A: 请参考已知限制章节了解具体限制。
使用范围限制
输入限制
- 代码实现请求: 用户必须明确请求代码实现,技能才会提供规划、执行指导和验证工作流。
- 文件路径: 用户提供的偏好存储在
$HOME/code/目录下,路径错误可能导致技能无法正确读取或存储数据。 - 文件格式: 用户提供的参考文件必须是Markdown格式,其他格式文件可能导致技能无法正确处理。
性能边界
- 处理速度: 对于复杂的代码实现请求,技能的处理速度可能受到影响,因为需要逐步规划和验证。
- 内存使用: 由于技能存储用户偏好和参考文件,内存使用量可能会随着文件数量的增加而增加。
兼容性约束
- 操作系统: 技能支持Windows、macOS和Linux操作系统,但不保证在其他操作系统上运行。
- Agent平台: 技能基于SKILL.md,需要支持SKILL.md的AI Agent平台,如Claude Code、Cursor、Codex或Gemini CLI等。
- LLM API: 技能依赖于LLM API,需要Agent平台提供内置LLM支持。
其他限制
- 自动执行代码: 技能不会自动执行代码,所有代码执行都需要用户明确指示。
- 网络请求: 技能不会进行网络请求,所有操作都在本地进行。
- 文件访问: 技能只能访问
$HOME/code/目录和用户的项目文件,不能访问其他文件或目录。 - 自主行动: 技能不会在没有用户意识的情况下采取自主行动,所有操作都需要用户授权。