菜单
Use when writing API contracts, ADRs, feature specs, or quality checks. Trigger with documentation ops request. Loaded by ai-maestro-architect-agent-main-agent
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Use when decomposing systems into modules with clear boundaries. Trigger with modularization or module boundary request. Loaded by ai-maestro-architect-agent-main-agent
Use when designing architectures, identifying risks, creating roadmaps, or breaking work into tasks. Trigger with planning or architecture design request. Loaded by ai-maestro-architect-agent-main-agent
Use when managing requirements, initializing plans, or approving transitions. Trigger with requirements analysis or plan initialization request. Loaded by ai-maestro-architect-agent-main-agent
Use when recording stack choices, constraints, or managing handoffs. Trigger with session memory ops request. Loaded by ai-maestro-architect-agent-main-agent
Use when persisting decisions, patterns, and constraints across sessions. Trigger with session memory or handoff request. Loaded by ai-maestro-architect-agent-main-agent
Use when managing design document states or lifecycle transitions. Trigger with design lifecycle or state transition request. Loaded by ai-maestro-architect-agent-main-agent
| name | amaa-documentation-writing-ops |
| description | Use when writing API contracts, ADRs, feature specs, or quality checks. Trigger with documentation ops request. Loaded by ai-maestro-architect-agent-main-agent |
| context | fork |
| user-invocable | false |
| agent | ai-maestro-architect-agent-main-agent |
Operational procedures for writing API contracts, ADRs, feature specifications, process documentation, and performing 6 C's quality checks.
/docs/, /docs_dev/requirements/)Copy this checklist and track your progress:
| Document | Content |
|---|---|
| op-write-api-contract.md | Purpose, When to Use, Inputs, Procedure, Overview, Authentication, Error Handling |
| op-write-adr.md | Purpose, When to Use, Inputs, Procedure, Example, Context, Error Handling |
| op-write-feature-spec.md | Purpose, When to Use, Inputs, Procedure, Overview, User Stories, Error Handling |
| op-write-process-doc.md | Purpose, When to Use, Inputs, Procedure, Overview, Roles and Responsibilities, Error Handling |
| op-quality-check-6c.md | Purpose, When to Use, Inputs, Procedure, Summary, Issues Found, Error Handling |
Example: "Write an ADR for switching from REST to GraphQL" produces /docs/adrs/ADR-042-graphql-migration.md
Example: "Create API contract for /api/users" produces /docs/api-contracts/users-api.md
| Issue | Fix |
|---|---|
| Missing context | Request source access from orchestrator |
| Quality check failed | Revise content, recheck 6 C's |
| Type | Description |
|---|---|
| API Contract | /docs/api-contracts/<api-name>.md |
| ADR | /docs/adrs/ADR-<NNN>-<title>.md |
| Feature Spec | /docs_dev/requirements/<feature-name>.md |
| Process Doc | /docs/workflows/<process-name>.md |
See Reference Documents table above.